home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / nftroff.zip / 11.tr < prev    next >
Text File  |  1991-11-21  |  63KB  |  2,987 lines
  1. .de }n
  2. .bp
  3. .sp .5i
  4. ..
  5. .wh -.8i }n
  6. .sp .5i
  7. .po -.4i
  8. .ll 7.5i
  9. .ps 9
  10. .vs 9
  11. .in 0i
  12. .ta 1.63265i
  13. .sp 2
  14. .ne 20
  15. .ps +3
  16. .vs +3
  17. @\.\.\.PROMPT    Define a menu item for use with MENU TO
  18. .br
  19. .ta
  20. .in 0.08i
  21. .ps -3
  22. .vs -3
  23. .sp 2
  24. \fB@\.\.\.PROMPT
  25. Define a menu item for use with MENU TO
  26. .in 0i
  27. .br
  28. \l'6.24i'
  29. .br
  30. .sp
  31. .in 0.08i
  32. \fBSyntax
  33. .sp
  34. .in 0.4i
  35. .br
  36. \fB#include "FTMENUTO\.CH"
  37. .in 0i
  38. .br
  39. \fB
  40. .in 0.4i
  41. .ta 4.96i
  42. .br
  43. \fB@ <nRow>, <nCol> PROMPT <cMenuItem>    ;
  44. .br
  45. .ta
  46. .in 2.32i
  47. .ta 3.04i
  48. .br
  49. \fB[ PROMPTCOLOR <cPromptColor> ]    ;
  50. .br
  51. .ta
  52. .ta 3.04i
  53. .br
  54. \fB[ MESSAGE <cItemMessage> ]    ;
  55. .br
  56. .ta
  57. .ta 3.04i
  58. .br
  59. \fB[ MSGROW <nMessageRow> ]    ;
  60. .br
  61. .ta
  62. .ta 3.04i
  63. .br
  64. \fB[ MSGCOL <nMessageCol> ]    ;
  65. .br
  66. .ta
  67. .ta 3.04i
  68. .br
  69. \fB[ MSGCOLOR <cMsgColor> ]    ;
  70. .br
  71. .ta
  72. .ta 3.04i
  73. .br
  74. \fB[ HOTKEY <nHotKeyPosition> ]    ;
  75. .br
  76. .ta
  77. .ta 3.04i
  78. .br
  79. \fB[ HOTKEYCOLOR <cHotKeyColor> ]    ;
  80. .br
  81. .ta
  82. .ta 3.04i
  83. .br
  84. \fB[ BARCOLOR <cBarColor> ]    ;
  85. .br
  86. .ta
  87. .ta 3.04i
  88. .br
  89. \fB[ BARHOTKEYCOLOR <cBarHotKeyColor> ]    ;
  90. .br
  91. .ta
  92. .ta 3.04i
  93. .br
  94. \fB[ UP <nUp> ]    ;
  95. .br
  96. .ta
  97. .ta 3.04i
  98. .br
  99. \fB[ DOWN <nDown> ]    ;
  100. .br
  101. .ta
  102. .ta 3.04i
  103. .br
  104. \fB[ RIGHT <nRight> ]    ;
  105. .br
  106. .ta
  107. .br
  108. \fB[ LEFT <nLeft> ]
  109. .sp
  110. .in 0.08i
  111. \fBArguments
  112. .sp
  113. .in 0.4i
  114. \fB<nRow>\fR is the row at which the prompt is to appear\.
  115. .sp
  116. \fB<nCol>\fR is the column at which the prompt will appear\.
  117. .sp
  118. \fB<cMenuItem>\fR is the menu item to display\.
  119. .sp
  120. \fB<cPromptColor>\fR is optional and is the color attribute of the
  121. prompt\. If not specified, the default is the current
  122. standard color as supplied by the SetColor() function\.
  123. .sp
  124. \fB<cItemMessage>\fR is optional and is the message associated with
  125. the prompt\. If not specified, then no message will be displayed\.
  126. .sp
  127. \fB<nMessageRow>\fR is optional and is the row at which the
  128. message, if any, will appear\.  If not specified, the default
  129. is the current setting of the SET MESSAGE TO command\.
  130. .sp
  131. \fB<nMessageCol>\fR is optional and is the column at which the
  132. message, if any, will appear\.  If not specified, the default
  133. is either zero or centered, depending on the current setting
  134. of the CENTER option of the SET MESSAGE TO command\.
  135. .sp
  136. \fB<cMsgColor>\fR is optional and is the color attribute of
  137. the message\. If not specified, the default is the current
  138. standard color as reported by the SetColor() function\.
  139. .sp
  140. \fB<nHotKeyPosition>\fR is optional and is the position within the
  141. prompt string where the hotkey is located\.  If not
  142. specified, the default is one\.
  143. .sp
  144. \fB<cHotKeyColor>\fR is optional and is the color attribute of the
  145. hotkey character\.  If not specified, the default is the same
  146. color as the rest of the prompt\.
  147. .sp
  148. \fB<cBarColor>\fR is optional and is the color attribute of
  149. the light bar when it is positioned on this prompt\.  If not
  150. specified, the default is the current enhanced color setting
  151. as returned by the SetColor() function\.
  152. .sp
  153. \fB<cBarHotKeyColor>\fR is optional and is the color
  154. attribute of the hotkey when the light bar is positioned on
  155. this prompt\.  If not specified, the default is the same
  156. color as the rest of the light bar\.
  157. .sp
  158. \fB<nUp>\fR is optional and specifies which prompt becomes active
  159. when the up arrow key is pressed\.  If not specified, the
  160. default is the previous prompt\.  The current setting of SET
  161. WRAP TO is obeyed\.
  162. .sp
  163. \fB<nDown>\fR is optional and specifies which prompt becomes
  164. active when the down arrow key is pressed\.  If not
  165. specified, the default is the next prompt\.  The current
  166. setting of SET WRAP TO is obeyed\.
  167. .sp
  168. \fB<nRight>\fR is optional and specifies which prompt becomes
  169. active when the right arrow key is pressed\.  If not
  170. specified, the default is the next prompt\.  The current
  171. setting of SET WRAP TO is obeyed\.
  172. .sp
  173. \fB<nLeft>\fR is optional and specifies which prompt becomes
  174. active when the left arrow is pressed\.  If not specified,
  175. the default is the previous prompt\.  The current setting of
  176. SET WRAP TO is obeyed\.
  177. .sp
  178. .in 0.08i
  179. \fBDescription
  180. .sp
  181. .in 0.4i
  182. This enhanced version of @\.\.\.PROMPT requires the inclusion of
  183. the header file FTMENUTO\.CH in any source file that uses it\.
  184. It is compatible with, and may be used in place of, the standard
  185. Clipper @\.\.\.PROMPT command\.
  186. .sp
  187. Clipper\'s @\.\.\.PROMPT and MENU TO commands are fine as far as
  188. they go\.  But many times you need more flexibility\.  As
  189. you\'ll no doubt notice if you read the argument list, this
  190. function is almost completely flexible\. You can adjust
  191. locations and colors for every part of the prompt and its
  192. associated message\.  In addition, since you can control the
  193. effect of the arrow keys, you can allow both horizontal and
  194. vertical movement, or even disable certain arrow keys if you
  195. so desire\.
  196. .sp
  197. Note that this command can also be called using function-style
  198. syntax\.  See the entry for FT_PROMPT() for further details\.
  199. .sp
  200. Also note that this command calls an internal routine called
  201. __FTPROMPT()\. __FTPROMPT() was written in assembler\.  Check
  202. the file TMENU\.ASM if you\'re interested in seeing the
  203. assembler source code\.
  204. .sp
  205. All the examples below use the command version\.  If you\'re
  206. interested in seeing the function version, compile the
  207. examples with the /P switch and then examine the resulting
  208. \.PPO file\.
  209. .sp
  210. .in 0.08i
  211. \fBExamples
  212. .sp
  213. .in 0.32i
  214. .br
  215. #include "FTMENUTO\.CH"
  216. .br
  217. // Simple prompt
  218. .br
  219. @ 1, 1 PROMPT "Menu choice #1"
  220. .sp
  221. .br
  222. // Prompt with color
  223. .br
  224. @ 3, 1 PROMPT "Menu choice #2" PROMPTCOLOR W+/R
  225. .sp
  226. .br
  227. // Prompt with a message
  228. .br
  229. @ 5, 1 PROMPT "Menu choice #3" MESSAGE "Go to lunch"
  230. .sp
  231. .br
  232. // Prompt with pinpoint message control
  233. .br
  234. @ 7, 1 PROMPT "Menu choice #4" MESSAGE "Drop Dead" ;
  235. .in 1.52i
  236. .br
  237. MSGROW 22 MSGCOL 4 MSGCOLOR GR+/N
  238. .sp
  239. .in 0.32i
  240. .br
  241. // Prompt with a unique lightbar color
  242. .br
  243. @ 9, 1 PROMPT "Menu choice #5" BARCOLOR BG+/W
  244. .sp
  245. .br
  246. // Prompt with a hotkey ("#" character)
  247. .br
  248. @11, 1 PROMPT "Menu choice #6" HOTKEY 13
  249. .sp
  250. .br
  251. // Prompt with pinpoint hotkey control
  252. .br
  253. @13, 1 PROMPT "Menu Choice #7" HOTKEY 13 ;
  254. .in 1.52i
  255. .br
  256. HOTKEYCOLOR R+/BG BARHOTKEYCOLOR G+/N
  257. .sp
  258. .in 0.32i
  259. .br
  260. // Prompt with right and left arrow keys disabled
  261. .br
  262. @15, 1 PROMPT "Menu Choice #8" RIGHT 8 LEFT 8
  263. .sp
  264. .in 0.08i
  265. \fBHeader File:\fR FTMENUTO\.CH
  266. .sp
  267. \fBSource:\fR ATPROMPT\.PRG
  268. .sp
  269. \fBAuthor:\fR Ted Means
  270. .in 0i
  271. .sp
  272. .in 1.5i
  273. .ti -1.5i
  274. .ta 1.5i
  275. .ft B
  276. See Also:    
  277. .ft R
  278. MENU TO
  279. , FT_PROMPT()
  280. , FT_MENUTO()
  281. .ta 1.63265i
  282. .in 0i
  283. .sp 2
  284. .ne 20
  285. .ps +3
  286. .vs +3
  287. FT_ACH2TB()    Replace ACHOICE() with a Tbrowse object
  288. .br
  289. .ta
  290. .in 0.08i
  291. .ps -3
  292. .vs -3
  293. .sp 2
  294. \fBFT_ACH2TB()
  295. Replace ACHOICE() with a Tbrowse object
  296. .in 0i
  297. .br
  298. \l'6.24i'
  299. .br
  300. .sp
  301. .in 0.08i
  302. \fBSyntax
  303. .sp
  304. .in 0.4i
  305. .ta 5.92i
  306. .br
  307. \fBFT_Ach2tb( <nToprow>,<nTopcol> [, <nBotrow> ][, <nBotcol> ],<aArray>,    ;
  308. .br
  309. .ta
  310. .in 0.88i
  311. .ta 5.68i
  312. .br
  313. \fB[ <cBoxtype> ],[ <cBoxcolor> ],[ <cBoxtitle> ],[ <nTitlePos> ],    ;
  314. .br
  315. .ta
  316. .ta 5.68i
  317. .br
  318. \fB[ <cUselcolor> ],[ <cTitlecolor> ],[ <cBarcolor> ],[ <cHkcolor> ],    ;
  319. .br
  320. .ta
  321. .ta 5.68i
  322. .br
  323. \fB[ <cShadow> ],[ <lExecute> ],[ <nMsgrow> ],[ <nMsgcol> ],    ;
  324. .br
  325. .ta
  326. .ta 5.28i
  327. .br
  328. \fB[ <cMsgcolor> ],[cElevbar],[cEbarcolor],[ <cEbarside> ],    ;
  329. .br
  330. .ta
  331. .ta 5.76i
  332. .br
  333. \fB[ <cNoSelcolor> ],[ <cTagch> ],[ <nStartelem> ],[ <lRestscrn> ],    ;
  334. .br
  335. .ta
  336. .br
  337. \fB[ <nTimeout> ],[ <bUserfunc> ] )
  338. .in 0.48i
  339. .br
  340. \fB-> nOption
  341. .sp
  342. .in 0.08i
  343. \fBArguments
  344. .sp
  345. .in 0.16i
  346. .ta 0.96i
  347. \fB<nToprow>\fR    is the top row of the box to be drawn\.  Required\.
  348. .br
  349. .ta
  350. .sp
  351. .ta 0.96i
  352. \fB<nTopcol>\fR    is the top column of the box to be drawn\.  Required\.
  353. .br
  354. .ta
  355. .sp
  356. .ta 0.96i
  357. \fB<nBotrow>\fR    is the bottom row of the box to be drawn\.  The default is
  358. .br
  359. .ta
  360. .in 0.4i
  361. \fB<nToprow>+Len(\fR<aArray>)+1 or maxrow()-2, whichever is less\.
  362. .sp
  363. .in 0.16i
  364. .ta 0.96i
  365. \fB<nBotcol>\fR    is the bottom column of the box to be drawn\.  The default
  366. .br
  367. .ta
  368. .in 0.4i
  369. is \fB<nTopcol>+width of the widest element in \fR<aArray>+2\.
  370. .sp
  371. .in 0.16i
  372. .ta 0.96i
  373. \fB<aArray>\fR    is the array of options to present to the user\.  Each
  374. .br
  375. .ta
  376. .in 0.4i
  377. element can hold as many as five subelements, or as few as one\.
  378. Required\.  Additional documentation below, in "Description\."
  379. .sp
  380. .in 0.16i
  381. \fB<cBoxtype>\fR is the type of box to draw\.  Uses DispBox()\.  The
  382. .in 0.4i
  383. default is a double-line box\.
  384. .sp
  385. .in 0.16i
  386. \fB<cBoxcolor>\fR is the color with which to draw the box\.  The default is
  387. .in 0.4i
  388. Setcolor()\.
  389. .sp
  390. .in 0.16i
  391. \fB<